Small doc improvements

diff --git a/gtk/gtkapplicationwindow.c b/gtk/gtkapplicationwindow.c
index 079f4bbdb2ebff52e7cf94286f6294d33537435f..caee9b1c6ef4d5b65d6b0044468f2efa36d5f4a2 100644 (file)
--- a/gtk/gtkapplicationwindow.c
+++ b/gtk/gtkapplicationwindow.c
@@ -82,7 +82,9 @@
  * looks on different platforms).
  * This behaviour can be overridden with the #GtkApplicationWindow:show-menubar
  * property. If the desktop environment does not display the application
- * menu, then it will automatically be included in the menubar.
+ * menu, then it will automatically be included in the menubar. It can
+ * also be shown as part of client-side window decorations, e.g. by
+ * using gtk_header_bar_set_show_fallback_app_menu().
  *
  * <example><title>A GtkApplicationWindow with a menubar</title>
  * <programlisting><![CDATA[

diff --git a/gtk/gtkheaderbar.c b/gtk/gtkheaderbar.c
index 24be7290eb831b08fb14847377d4937b7795a792..a22b95c193ab4ff86dcfe416422a0e376b4be97a 100644 (file)
--- a/gtk/gtkheaderbar.c
+++ b/gtk/gtkheaderbar.c
@@ -1908,7 +1908,8 @@ gtk_header_bar_get_show_fallback_app_menu (GtkHeaderBar *bar)
  * @setting: %TRUE to enable the fallback application menu
  *
  * Sets whether this header bar may show a menu button
- * for the application menu when needed.
+ * for the application menu when it is not shown by the
+ * desktop environment.
  *
  * Since: 3.12
  */